home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmLabelGadget.z / XmLabelGadget
Encoding:
Text File  |  2002-10-03  |  62.1 KB  |  925 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt - The LabelGadget widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/LabelG.h>
  13.  
  14.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  15.           This page documents Motif 2.1.
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           LabelGadget is an instantiable widget and is also used as a
  19.           superclass for other button gadgets, such as
  20.           PushButtonGadget and ToggleButtonGadget.
  21.  
  22.           LabelGadget can contain either text or a pixmap. LabelGadget
  23.           text is a compound string.  Refer to the _M_o_t_i_f
  24.           _P_r_o_g_r_a_m_m_e_r'_sGuide for more information on compound strings.
  25.           The text can be multilingual, multiline, and/or multifont.
  26.           When a LabelGadget is insensitive, its text is stippled, or
  27.           the user-supplied insensitive pixmap is displayed.
  28.  
  29.           LabelGadget supports both accelerators and mnemonics
  30.           primarily for use in LabelGadget subclass widgets that are
  31.           contained in menus. Mnemonics are available in a menu system
  32.           when the button is visible. Accelerators in a menu system
  33.           are accessible even when the button is not visible.  The
  34.           LabelGadget displays the mnemonic by underlining the first
  35.           matching character in the text string. The accelerator is
  36.           displayed as a text string adjacent to the label text or
  37.           pixmap, depending on the layout direction.
  38.  
  39.           LabelGadget consists of many margin fields surrounding the
  40.           text or pixmap.  These margin fields are resources that may
  41.           be set by the user, but LabelGadget subclasses and Manager
  42.           parents also modify some of these fields. They tend to
  43.           modify the XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnLLLLeeeefffftttt, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnRRRRiiiigggghhhhtttt, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnTTTToooopppp, and
  44.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnBBBBoooottttttttoooommmm resources and leave the XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh and
  45.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt resources as set by the application.
  46.  
  47.           LabelGadget takes into account XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss in
  48.           determining its layout but does not draw the shadow.  That
  49.           is, if XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss is greater than 0 (zero),
  50.           LabelGadget leaves space for the shadow, but the shadow does
  51.           not appear.
  52.  
  53.           In a LabelGadget, XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn and XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttOOOOnnnnEEEEnnnntttteeeerrrr are
  54.           forced to False inside Popup menu panes, Pulldown menu
  55.           panes, and OptionMenus.  Otherwise these resources default
  56.           to False.
  57.  
  58.           LabelGadget uses the _X_m_Q_T_m_e_n_u_S_y_s_t_e_m and
  59.           _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e traits, and holds the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l, _X_m_Q_T_c_a_r_e_P_a_r_e_n_t_V_i_s_u_a_l, _X_m_Q_T_m_e_n_u_S_a_v_v_y, and
  75.           _X_m_Q_T_t_r_a_n_s_f_e_r traits.
  76.  
  77.         DDDDaaaattttaaaa TTTTrrrraaaannnnssssffffeeeerrrr BBBBeeeehhhhaaaavvvviiiioooorrrr
  78.           LabelGadget and it subclasses, except when used in a menu
  79.           system, support dragging of the label contents from the
  80.           LabelGadget.  However, the label contents are draggable only
  81.           if the XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeUUUUnnnnsssseeeelllleeeeccccttttaaaabbbblllleeeeDDDDrrrraaaagggg resource of XXXXmmmmDDDDiiiissssppppllllaaaayyyyis set
  82.           to True.
  83.  
  84.           As a source of data, LabelGadget and its subclasses support
  85.           the following targets and associated conversions of data to
  86.           these targets:
  87.  
  88.           _l_o_c_a_l_e    If the _l_o_c_a_l_e target matches the widget's locale,
  89.                     the widget transfers XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg in the
  90.                     encoding of the locale.  This target is supported
  91.                     only when XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG.
  92.  
  93.           _C_O_M_P_O_U_N_D__T_E_X_T
  94.                     The widget transfers XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg as type
  95.                     _C_O_M_P_O_U_N_D__T_E_X_T.  This target is supported only when
  96.                     XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG.
  97.  
  98.           _P_I_X_M_A_P    The widget transfers XXXXmmmmNNNNllllaaaabbbbeeeellllPPPPiiiixxxxmmmmaaaapppp as type
  99.                     _D_R_A_W_A_B_L_E.  This target is supported only when
  100.                     XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP.
  101.  
  102.           _S_T_R_I_N_G    The widget transfers XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg as type
  103.                     _S_T_R_I_N_G.  This target is supported only when
  104.                     XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG.
  105.  
  106.           _T_E_X_T      If XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg is fully convertible to the
  107.                     encoding of the locale, the widget transfers
  108.                     XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg in the encoding of the locale.
  109.                     Otherwise, the widget transfers XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg as
  110.                     type _C_O_M_P_O_U_N_D__T_E_X_T.  This target is supported only
  111.                     when XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG.
  112.  
  113.           ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS
  114.                     The widget transfers, as type _A_T_O_M, a list of the
  115.                     targets it supports for the _C_L_I_P_B_O_A_R_D selection.
  116.                     When XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG, these include the
  117.                     following targets:
  118.  
  119.                        +o  ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG
  120.  
  121.                        +o  _C_O_M_P_O_U_N_D__T_E_X_T
  122.  
  123.                        +o  The encoding of the locale, if
  124.                           XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg is fully convertible to the
  125.                           encoding of the locale
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                        +o  _S_T_R_I_N_G, if XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg is fully
  141.                           convertible to _S_T_R_I_N_G
  142.  
  143.                     When XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP, the targets include
  144.                     _P_I_X_M_A_P.
  145.  
  146.           ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG
  147.                     The widget transfers XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg as a compound
  148.                     string in Byte Stream format.  This target is
  149.                     supported only when XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG.
  150.  
  151.           ____MMMMOOOOTTTTIIIIFFFF____EEEEXXXXPPPPOOOORRRRTTTT____TTTTAAAARRRRGGGGEEEETTTTSSSS
  152.                     The widget transfers, as type _A_T_O_M, a list of the
  153.                     targets to be used as the value of the
  154.                     DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss in a drag-and-drop
  155.                     transfer.  When XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG, these
  156.                     include ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG, _C_O_M_P_O_U_N_D__T_E_X_T, the
  157.                     encoding of the locale, _S_T_R_I_N_G, _T_E_X_T, _B_A_C_K_G_R_O_U_N_D,
  158.                     and _F_O_R_E_G_R_O_U_N_D.  When XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP,
  159.                     these include _P_I_X_M_A_P, _B_A_C_K_G_R_O_U_N_D, and _F_O_R_E_G_R_O_U_N_D.
  160.  
  161.           As a source of data, LabelGadget also supports the following
  162.           standard Motif targets:
  163.  
  164.           _B_A_C_K_G_R_O_U_N_D
  165.                     The widget transfers the parent's XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd as
  166.                     type _P_I_X_E_L.
  167.  
  168.           _C_L_A_S_S     The widget finds the first shell in the widget
  169.                     hierarchy that has a WWWWMMMM____CCCCLLLLAAAASSSSSSSS property and
  170.                     transfers the contents as text in the current
  171.                     locale.
  172.  
  173.           _C_L_I_E_N_T__W_I_N_D_O_W
  174.                     The widget finds the first shell in the widget
  175.                     hierarchy and transfers its window as type _W_I_N_D_O_W.
  176.  
  177.           _C_O_L_O_R_M_A_P  The widget transfers the parent's XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp as
  178.                     type _C_O_L_O_R_M_A_P.
  179.  
  180.           _F_O_R_E_G_R_O_U_N_D
  181.                     The widget transfers the parent's XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd as
  182.                     type _P_I_X_E_L.
  183.  
  184.           _N_A_M_E      The widget finds the first shell in the widget
  185.                     hierarchy that has a WWWWMMMM____NNNNAAAAMMMMEEEE property and
  186.                     transfers the contents as text in the current
  187.                     locale.
  188.  
  189.           _T_A_R_G_E_T_S   The widget transfers, as type _A_T_O_M, a list of the
  190.                     targets it supports.  These include the standard
  191.                     targets in this list.  When XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG, these also include
  207.                     ____MMMMOOOOTTTTIIIIFFFF____CCCCOOOOMMMMPPPPOOOOUUUUNNNNDDDD____SSSSTTTTRRRRIIIINNNNGGGG, _C_O_M_P_O_U_N_D__T_E_X_T, the
  208.                     encoding of the locale, _S_T_R_I_N_G, and _T_E_X_T.  When
  209.                     XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP, these also include
  210.                     _P_I_X_M_A_P.
  211.  
  212.           _T_I_M_E_S_T_A_M_P The widget transfers the timestamp used to acquire
  213.                     the selection as type _I_N_T_E_G_E_R.
  214.  
  215.           ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE
  216.                     The widget transfers XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee if it exists,
  217.                     or else the default text render table, as type
  218.                     _S_T_R_I_N_G.
  219.  
  220.           ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY
  221.                     The widget transfers its encoding registry as type
  222.                     _S_T_R_I_N_G.  The value is a list of NULL separated
  223.                     items in the form of tag encoding pairs.  This
  224.                     target symbolizes the transfer target for the
  225.                     Motif Segment Encoding Registry.  Widgets and
  226.                     applications can use this Registry to register
  227.                     text encoding formats for specified render table
  228.                     tags.  Applications access this Registry by
  229.                     calling XXXXmmmmRRRReeeeggggiiiisssstttteeeerrrrSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg and
  230.                     XXXXmmmmMMMMaaaappppSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg.
  231.  
  232.         CCCCllllaaaasssssssseeeessss
  233.           LabelGadget inherits behavior, resources, and traits from
  234.           OOOObbbbjjjjeeeecccctttt, RRRReeeeccccttttOOOObbbbjjjj and XXXXmmmmGGGGaaaaddddggggeeeetttt.
  235.  
  236.           The class pointer is _x_m_L_a_b_e_l_G_a_d_g_e_t_C_l_a_s_s.
  237.  
  238.           The class name is XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt.
  239.  
  240.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  241.           The following table defines a set of widget resources used
  242.           by the programmer to specify data. The programmer can also
  243.           set the resource values for the inherited classes to set
  244.           attributes for this widget. To reference a resource by name
  245.           or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  246.           prefix and use the remaining letters. To specify one of the
  247.           defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
  248.           the XXXXmmmm prefix and use the remaining letters (in either
  249.           lowercase or uppercase, but include any underscores between
  250.           words).  The codes in the access column indicate if the
  251.           given resource can be set at creation time (C), set by using
  252.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  253.           not applicable (N/A).
  254.  
  255.                                                  XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 10/3/02)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  269.  
  270.  
  271.  
  272.           NNNNaaaammmmeeee                        CCCCllllaaaassssssss                       TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  273.           XmNaccelerator              XmCAccelerator              String              NULL                   CSG
  274.           XmNacceleratorText          XmCAcceleratorText          XmString            NULL                   CSG
  275.           XmNalignment                XmCAlignment                unsigned char       dynamic                CSG
  276.           XmNfontList                 XmCFontList                 XmFontList          dynamic                CSG
  277.           XmNlabelInsensitivePixmap   XmCLabelInsensitivePixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  278.           XmNlabelPixmap              XmCLabelPixmap              Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  279.           XmNlabelString              XmCXmString                 XmString            dynamic                CSG
  280.           XmNlabelType                XmCLabelType                unsigned char       XmSTRING               CSG
  281.           XmNmarginBottom             XmCMarginBottom             Dimension           0                      CSG
  282.           XmNmarginHeight             XmCMarginHeight             Dimension           2                      CSG
  283.           XmNmarginLeft               XmCMarginLeft               Dimension           0                      CSG
  284.           XmNmarginRight              XmCMarginRight              Dimension           0                      CSG
  285.           XmNmarginTop                XmCMarginTop                Dimension           0                      CSG
  286.           XmNmarginWidth              XmCMarginWidth              Dimension           2                      CSG
  287.           XmNmnemonic                 XmCMnemonic                 KeySym              NULL                   CSG
  288.           XmNmnemonicCharSet          XmCMnemonicCharSet          String              dynamic                CSG
  289.           XmNrecomputeSize            XmCRecomputeSize            Boolean             True                   CSG
  290.           XmNrenderTable              XmCRenderTable              XmRenderTable       dynamic                CSG
  291.           XmNstringDirection          XmCStringDirection          XmStringDirection   dynamic                CSG
  292.  
  293.           XXXXmmmmNNNNaaaacccccccceeeelllleeeerrrraaaattttoooorrrr
  294.                     Sets the accelerator on a button widget in a menu,
  295.                     which activates a visible or invisible, but
  296.                     managed, button from the keyboard.  This resource
  297.                     is a string that describes a set of modifiers and
  298.                     the key that may be used to select the button.
  299.                     The format of this string is identical to that
  300.                     used by the translations manager, with the
  301.                     exception that only a single event may be
  302.                     specified and only KKKKeeeeyyyyPPPPrrrreeeessssssss events are allowed.
  303.  
  304.                     Accelerators for buttons are supported only for
  305.                     PushButtonGadgets and ToggleButtonGadgets in
  306.                     Pulldown and Popup menus.
  307.  
  308.           XXXXmmmmNNNNaaaacccccccceeeelllleeeerrrraaaattttoooorrrrTTTTeeeexxxxtttt
  309.                     Specifies the text displayed for the accelerator.
  310.                     The text is displayed adjacent to the label string
  311.                     or pixmap. The direction of its layout depends on
  312.                     the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource of the widget.
  313.                     Accelerator text for buttons is displayed only for
  314.                     PushButtonGadgets and ToggleButtonGadgets in
  315.                     Pulldown and Popup Menus.
  316.  
  317.           XXXXmmmmNNNNaaaalllliiiiggggnnnnmmmmeeeennnntttt
  318.                     Specifies the label alignment for text or pixmap.
  319.  
  320.                     XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG (left alignment)
  321.                               Causes the left sides of the lines of
  322.                               text to be vertically aligned with the
  323.                               left edge of the gadget. For a pixmap,
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 10/3/02)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  335.  
  336.  
  337.  
  338.                               its left side is vertically aligned with
  339.                               the left edge of the gadget.
  340.  
  341.                     XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCEEEENNNNTTTTEEEERRRR (center alignment)
  342.                               Causes the centers of the lines of text
  343.                               to be vertically aligned in the center
  344.                               of the gadget. For a pixmap, its center
  345.                               is vertically aligned with the center of
  346.                               the gadget.
  347.  
  348.                     XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____EEEENNNNDDDD (right alignment)
  349.                               Causes the right sides of the lines of
  350.                               text to be vertically aligned with the
  351.                               right edge of the gadget. For a pixmap,
  352.                               its right side is vertically aligned
  353.                               with the right edge of the gadget.
  354.  
  355.                     The preceding descriptions for text are correct
  356.                     when XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmLLLLEEEEFFFFTTTT____TTTTOOOO____RRRRIIIIGGGGHHHHTTTT. When
  357.                     that resource is XXXXmmmmRRRRIIIIGGGGHHHHTTTT____TTTTOOOO____LLLLEEEEFFFFTTTT, the descriptions
  358.                     for XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG and XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____EEEENNNNDDDD are
  359.                     switched.
  360.  
  361.                     If the parent is a RowColumn whose XXXXmmmmNNNNiiiissssAAAAlllliiiiggggnnnneeeedddd
  362.                     resource is True, XXXXmmmmNNNNaaaalllliiiiggggnnnnmmmmeeeennnntttt is forced to the
  363.                     same value as the RowColumn's XXXXmmmmNNNNeeeennnnttttrrrryyyyAAAAlllliiiiggggnnnnmmmmeeeennnntttt if
  364.                     the RowColumn's XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA or
  365.                     if the gadget is a subclass of XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt.
  366.                     Otherwise, the default is XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCEEEENNNNTTTTEEEERRRR.
  367.  
  368.           XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt
  369.                     Specifies the font of the text used in the gadget.
  370.                     XXXXmmmmNNNNffffoooonnnnttttLLLLiiiissssttttis obsolete and exists for
  371.                     compatibility with previous releases. You should
  372.                     now use XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee instead of XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt. If
  373.                     both are specified, the render table will take
  374.                     precedence. If XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt is NULL at
  375.                     initialization, the parent hierarchy of the widget
  376.                     is searched for an ancestor that is a subclass of
  377.                     the XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd, VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll, or XXXXmmmmMMMMeeeennnnuuuuSSSShhhheeeellllllll
  378.                     widget class. If such an ancestor is found, the
  379.                     font list is initialized to the XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnFFFFoooonnnnttttLLLLiiiisssstttt
  380.                     (for button gadget subclasses) or XXXXmmmmNNNNllllaaaabbbbeeeellllFFFFoooonnnnttttLLLLiiiisssstttt
  381.                     of the ancestor widget. If no such ancestor is
  382.                     found, the default is implementation dependent.
  383.                     Refer to XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt(3) for more information on the
  384.                     creation and structure of a font list.
  385.  
  386.           XXXXmmmmNNNNllllaaaabbbbeeeellllIIIInnnnsssseeeennnnssssiiiittttiiiivvvveeeePPPPiiiixxxxmmmmaaaapppp
  387.                     Specifies a pixmap used as the button face if
  388.                     XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP and the button is
  389.                     insensitive.  The default value,
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 10/3/02)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                     XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP, displays an empty label.
  405.  
  406.           XXXXmmmmNNNNllllaaaabbbbeeeellllPPPPiiiixxxxmmmmaaaapppp
  407.                     Specifies the pixmap when XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is
  408.                     XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP.  The default value,
  409.                     XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP, displays an empty label.
  410.  
  411.           XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  412.                     Specifies the compound string when XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee is
  413.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG.  If the value of this resource is NULL,
  414.                     it is initialized to name of the gadget converted
  415.                     to a compound string.  Refer to XXXXmmmmSSSSttttrrrriiiinnnngggg(3) for
  416.                     more information on the creation and the structure
  417.                     of compound strings.
  418.  
  419.           XXXXmmmmNNNNllllaaaabbbbeeeellllTTTTyyyyppppeeee
  420.                     Specifies the label type.
  421.  
  422.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG  Text displays XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  423.  
  424.                     XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP  Icon data in pixmap displays
  425.                               XXXXmmmmNNNNllllaaaabbbbeeeellllPPPPiiiixxxxmmmmaaaapppp or
  426.                               XXXXmmmmNNNNllllaaaabbbbeeeellllIIIInnnnsssseeeennnnssssiiiittttiiiivvvveeeePPPPiiiixxxxmmmmaaaapppp
  427.  
  428.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnBBBBoooottttttttoooommmm
  429.                     Specifies the amount of spacing between the bottom
  430.                     of the label text and the top of the bottom margin
  431.                     specified by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt.  This may be
  432.                     modified by LabelGadget's subclasses.  For
  433.                     example, CascadeButtonGadget may increase this
  434.                     field to make room for the cascade pixmap.
  435.  
  436.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
  437.                     Specifies an equal amount of spacing above the
  438.                     margin defined by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnTTTToooopppp and below the
  439.                     margin defined by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnBBBBoooottttttttoooommmm. XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
  440.                     specifies the amount of spacing between the top
  441.                     edge of the margin set by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnTTTTooooppppand the
  442.                     bottom edge of the top shadow, and the amount of
  443.                     spacing between the bottom edge of the margin
  444.                     specified by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnBBBBoooottttttttoooommmm and the top edge of
  445.                     the bottom shadow.
  446.  
  447.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnLLLLeeeefffftttt
  448.                     Specifies the amount of spacing between the left
  449.                     edge of the label text and the right side of the
  450.                     left margin (specified by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh).  This
  451.                     may be modified by LabelGadget's subclasses.  For
  452.                     example, ToggleButtonGadget may increase this
  453.                     field to make room for the toggle indicator and
  454.                     for spacing between the indicator and label.
  455.                     Whether this actually applies to the left or right
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 10/3/02)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  467.  
  468.  
  469.  
  470.                     side of the label depends on the value of
  471.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.
  472.  
  473.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnRRRRiiiigggghhhhtttt
  474.                     Specifies the amount of spacing between the right
  475.                     edge of the label text and the left side of the
  476.                     right margin (specified by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh).  This
  477.                     may be modified by LabelGadget's subclasses.  For
  478.                     example, CascadeButtonGadget may increase this
  479.                     field to make room for the cascade pixmap.
  480.                     Whether this actually applies to the left or right
  481.                     side of the label depends on the value of
  482.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.
  483.  
  484.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnTTTToooopppp
  485.                     Specifies the amount of spacing between the top of
  486.                     the label text and the bottom of the top margin
  487.                     specified by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt.  This may be
  488.                     modified by LabelGadget's subclasses.  For
  489.                     example, CascadeButtonGadget may increase this
  490.                     field to make room for the cascade pixmap.
  491.  
  492.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh
  493.                     Specifies an equal amount of spacing to the left
  494.                     of the margin defined by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnLLLLeeeefffftttt and to the
  495.                     right of the margin defined by XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnRRRRiiiigggghhhhtttt.
  496.                     XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh specifies the amount of spacing
  497.                     between the left edge of the margin set by
  498.                     XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnLLLLeeeeffffttttand the right edge of the left
  499.                     shadow, and the amount of spacing between the
  500.                     right edge of the margin specified by
  501.                     XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnRRRRiiiigggghhhhtttt and the left edge of the right
  502.                     shadow.
  503.  
  504.           XXXXmmmmNNNNmmmmnnnneeeemmmmoooonnnniiiicccc
  505.                     Provides the user with an alternate means of
  506.                     activating a button.  A button in a MenuBar, a
  507.                     Popup menu pane, or a Pulldown menu pane can have
  508.                     a mnemonic.
  509.  
  510.                     This resource contains a keysym as listed in the
  511.                     X11 keysym table.  The first character in the
  512.                     label string that exactly matches the mnemonic in
  513.                     the character set specified in
  514.                     XXXXmmmmNNNNmmmmnnnneeeemmmmoooonnnniiiiccccCCCChhhhaaaarrrrSSSSeeeettttis underlined when the button is
  515.                     displayed.
  516.  
  517.                     When a mnemonic has been specified, the user
  518.                     activates the button by pressing the mnemonic key
  519.                     while the button is visible.  If the button is a
  520.                     CascadeButtonGadget in a MenuBar and the MenuBar
  521.                     does not have the focus, the user must use the
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 10/3/02)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  533.  
  534.  
  535.  
  536.                     MMMMAAAAlllltttt modifier while pressing the mnemonic.  The
  537.                     user can activate the button by pressing either
  538.                     the shifted or the unshifted mnemonic key.
  539.  
  540.           XXXXmmmmNNNNmmmmnnnneeeemmmmoooonnnniiiiccccCCCChhhhaaaarrrrSSSSeeeetttt
  541.                     Specifies the character set of the mnemonic for
  542.                     the label.  The default is XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG.
  543.  
  544.           XXXXmmmmNNNNrrrreeeeccccoooommmmppppuuuutttteeeeSSSSiiiizzzzeeee
  545.                     Specifies a Boolean value that indicates whether
  546.                     the gadget shrinks or expands to accommodate its
  547.                     contents (label string or pixmap) as a result of
  548.                     an XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss resource value that would change
  549.                     the size of the gadget. If True, the gadget
  550.                     shrinks or expands to exactly fit the label string
  551.                     or pixmap.  If False, the gadget never attempts to
  552.                     change size on its own.
  553.  
  554.           XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee
  555.                     Specifies the render table associated with the
  556.                     llllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg. If this value is NULL at
  557.                     initialization, Label searches its parent
  558.                     hierarchy for an ancestor that holds the
  559.                     _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait.  If such an ancestor
  560.                     is found, Label initializes XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee to the
  561.                     XXXXmmmmLLLLAAAABBBBEEEELLLL____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of the ancestor widget.
  562.                     Similarly, button subclasses of Label initialize
  563.                     XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee to the XXXXmmmmBBBBUUUUTTTTTTTTOOOONNNN____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value
  564.                     of the ancestor widget. (Note that all current
  565.                     subclasses of Label are button subclasses.) If no
  566.                     such ancestor is found, the default is
  567.                     implementation dependent. If a font list and a
  568.                     render table are both specified, the render table
  569.                     will take precedence. Refer to XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee(3)
  570.                     for more information on the creation and structure
  571.                     of a render table.
  572.  
  573.           XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  574.                     Is a synthetic resource for setting
  575.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.  The values for this resource
  576.                     are XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN____LLLL____TTTTOOOO____RRRR and
  577.                     XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN____RRRR____TTTTOOOO____LLLL. Refer to the
  578.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource description. The
  579.                     XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource is obsoleted by
  580.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn, but is kept here for backward
  581.                     compatibility.
  582.  
  583.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  584.           LabelGadget inherits behavior and resources from the
  585.           superclasses described in the following tables.  For a
  586.           complete description of each resource, refer to the
  587.           reference page for that superclass.
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 10/3/02)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  599.  
  600.  
  601.  
  602.                                                XXXXmmmmGGGGaaaaddddggggeeeetttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  603.           NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee               DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  604.           XmNbackground           XmCBackground           Pixel              dynamic                CSG
  605.           XmNbackgroundPixmap     XmCPixmap               Pixmap             XmUNSPECIFIED_PIXMAP   CSG
  606.           XmNbottomShadowColor    XmCBottomShadowColor    Pixel              dynamic                CSG
  607.           XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap             dynamic                CSG
  608.           XmNhelpCallback         XmCCallback             XtCallbackList     NULL                   C
  609.           XmNforeground           XmCForeground           Pixel              dynamic                CSG
  610.           XmNhighlightColor       XmCHighlightColor       Pixel              dynamic                CSG
  611.           XmNhighlightOnEnter     XmCHighlightOnEnter     Boolean            False                  CSG
  612.           XmNhighlightPixmap      XmCHighlightPixmap      Pixmap             dynamic                CSG
  613.           XmNhighlightThickness   XmCHighlightThickness   Dimension          0                      CSG
  614.           XmNlayoutDirection      XmNCLayoutDirection     XmDirection        dynamic                CG
  615.           XmNnavigationType       XmCNavigationType       XmNavigationType   XmNONE                 CSG
  616.           XmNshadowThickness      XmCShadowThickness      Dimension          0                      CSG
  617.           XmNtopShadowColor       XmCTopShadowColor       Pixel              dynamic                CSG
  618.           XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap             dynamic                CSG
  619.           XmNtraversalOn          XmCTraversalOn          Boolean            False                  CSG
  620.           XmNunitType             XmCUnitType             unsigned char      dynamic                CSG
  621.           XmNuserData             XmCUserData             XtPointer          NULL                   CSG
  622.  
  623.                                   RRRReeeeccccttttOOOObbbbjjjj RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  624.           NNNNaaaammmmeeee                   CCCCllllaaaassssssss            TTTTyyyyppppeeee        DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  625.           XmNancestorSensitive   XmCSensitive     Boolean     dynamic   G
  626.           XmNborderWidth         XmCBorderWidth   Dimension   0         N/A
  627.           XmNheight              XmCHeight        Dimension   dynamic   CSG
  628.           XmNsensitive           XmCSensitive     Boolean     True      CSG
  629.           XmNwidth               XmCWidth         Dimension   dynamic   CSG
  630.           XmNx                   XmCPosition      Position    0         CSG
  631.           XmNy                   XmCPosition      Position    0         CSG
  632.  
  633.                                   OOOObbbbjjjjeeeecccctttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  634.           NNNNaaaammmmeeee                 CCCCllllaaaassssssss         TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  635.           XmNdestroyCallback   XmCCallback   XtCallbackList   NULL      C
  636.  
  637.         BBBBeeeehhhhaaaavvvviiiioooorrrr
  638.           XmLabelGadget includes behavior from XmGadget.  Additional
  639.           XmLabelGadget behavior is described in the following list:
  640.  
  641.           <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
  642.                     Drags the contents of a LabelGadget, identified
  643.                     when BBBBTTTTrrrraaaannnnssssffffeeeerrrr is pressed.  This action is
  644.                     undefined for LabelGadgets used in a menu system.
  645.  
  646.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>:
  647.                     In a Popup or Pulldown MenuPane, unposts all menus
  648.                     in the menu hierarchy and, when the shell's
  649.                     keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, restores
  650.                     keyboard focus to the widget that had the focus
  651.                     before the menu system was entered.  Calls the
  652.                     callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any exist.  If
  653.                     there are no help callbacks for this widget, this
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 10/3/02)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  665.  
  666.  
  667.  
  668.                     action calls the help callbacks for the nearest
  669.                     ancestor that has them.
  670.  
  671.           <<<<kkkkeeeeyyyy>>>><<<<oooossssffffCCCCaaaannnncccceeeellll>>>>:
  672.                     In a MenuBar, disarms the CascadeButton and the
  673.                     menu and, when the shell's keyboard focus policy
  674.                     is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, restores keyboard focus to the
  675.                     widget that had the focus before the menu was
  676.                     entered.
  677.  
  678.                     In a toplevel Pulldown MenuPane from a MenuBar,
  679.                     unposts the menu, disarms the MenuBar
  680.                     CascadeButton and the MenuBar, and, when the
  681.                     shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT,
  682.                     restores keyboard focus to the widget that had the
  683.                     focus before the MenuBar was entered.  In other
  684.                     Pulldown MenuPanes, unposts the menu.
  685.  
  686.                     In a Popup MenuPane, unposts the menu and, when
  687.                     the shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT,
  688.                     restores keyboard focus to the widget from which
  689.                     the menu was posted.
  690.  
  691.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
  692.                     If the current menu item has a submenu and is in a
  693.                     MenuBar, then this action posts the submenu,
  694.                     disarms the current menu item, and arms the
  695.                     submenu's first traversable menu item.
  696.  
  697.                     If the current menu item is in a MenuPane, then
  698.                     this action disarms the current menu item and arms
  699.                     the item below it. This action wraps within the
  700.                     MenuPane. The direction of the wrapping depends on
  701.                     the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.
  702.  
  703.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
  704.                     When the current menu item is in a MenuBar, then
  705.                     this action disarms the current item and arms the
  706.                     MenuBar item to the left.  This action wraps
  707.                     within the MenuBar.
  708.  
  709.                     In MenuPanes, if the current menu item is not at
  710.                     the left edge of a MenuPane, this action disarms
  711.                     the current item and arms the item to its left.
  712.                     If the current menu item is at the left edge of a
  713.                     submenu attached to a MenuBar item, then this
  714.                     action unposts the submenu and traverses to the
  715.                     MenuBar item to the left, wrapping if necessary.
  716.                     If that MenuBar item has a submenu, it posts the
  717.                     submenu and arms the first traversable item in the
  718.                     submenu.  If the current menu item is at the left
  719.                     edge of a submenu not directly attached to a
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 10/3/02)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  731.  
  732.  
  733.  
  734.                     MenuBar item, then this action unposts the current
  735.                     submenu only.
  736.  
  737.                     In Popup or Torn-off MenuPanes, when the current
  738.                     menu item is at the left edge, this action wraps
  739.                     within the MenuPane. If the current menu item is
  740.                     at the left edge of the MenuPane and not in the
  741.                     top row, this action wraps to the rightmost menu
  742.                     item in the row above. If the current menu item is
  743.                     in the upper, leftmost corner, this action wraps
  744.                     to the tear-off control, if present, or else it
  745.                     wraps to the bottom, rightmost menu item in the
  746.                     MenuPane.  The preceding description applies when
  747.                     the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn horizontal direction is
  748.                     XXXXmmmmLLLLEEEEFFFFTTTT____TTTTOOOO____RRRRIIIIGGGGHHHHTTTT. If the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn
  749.                     horizontal direction is XXXXmmmmRRRRIIIIGGGGHHHHTTTT____TTTTOOOO____LLLLEEEEFFFFTTTT, then the
  750.                     following applies.
  751.  
  752.                     If the current menu item is in a MenuBar, then
  753.                     this action disarms the current item and arms the
  754.                     MenuBar item to the left.  This action wraps
  755.                     within the MenuBar.
  756.  
  757.                     In MenuPanes, if the current menu item is a
  758.                     CascadeButton, then this action posts its
  759.                     associated submenu.  If the current menu item is
  760.                     not a CascadeButton and is not at the left edge of
  761.                     a MenuPane, this action disarms the current item
  762.                     and arms the item to its left, wrapping if
  763.                     necessary.  If the current menu item is not a
  764.                     CascadeButton and is at the left edge of a submenu
  765.                     that is a descendent of a MenuBar, then this
  766.                     action unposts all submenus and traverses to the
  767.                     MenuBar item to the left.  If that MenuBar item
  768.                     has a submenu, it posts the submenu and arms the
  769.                     submenu's first traversable item.
  770.  
  771.                     In Popup or Torn-off menus, if the current menu
  772.                     item is not a CascadeButton and is at the left
  773.                     edge of a row (except the bottom row), this action
  774.                     wraps to the rightmost menu item in the row below.
  775.                     If the current menu item is not a CascadeButton
  776.                     and is in the bottom, leftmost corner of a Popup
  777.                     or Pulldown MenuPane, this action wraps to the
  778.                     tear-off control, if present, or else it wraps to
  779.                     the top, rightmost menu item of the MenuPane.
  780.  
  781.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
  782.                     If the current menu item is in a MenuBar, then
  783.                     this action disarms the current item and arms the
  784.                     MenuBar item to the right.  This action wraps
  785.                     within the MenuBar.
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 10/3/02)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  797.  
  798.  
  799.  
  800.                     In MenuPanes, if the current menu item is a
  801.                     CascadeButton, then this action posts its
  802.                     associated submenu.  If the current menu item is
  803.                     not a CascadeButton and is not at the right edge
  804.                     of a MenuPane, this action disarms the current
  805.                     item and arms the item to its right, wrapping if
  806.                     necessary.  If the current menu item is not a
  807.                     CascadeButton and is at the right edge of a
  808.                     submenu that is a descendent of a MenuBar, then
  809.                     this action unposts all submenus and traverses to
  810.                     the MenuBar item to the right.  If that MenuBar
  811.                     item has a submenu, it posts the submenu and arms
  812.                     the submenu's first traversable item.
  813.  
  814.                     In Popup or Torn-off menus, if the current menu
  815.                     item is not a CascadeButton and is at the right
  816.                     edge of a row (except the bottom row), this action
  817.                     wraps to the leftmost menu item in the row below.
  818.                     If the current menu item is not a CascadeButton
  819.                     and is in the bottom, rightmost corner of a Popup
  820.                     or Pulldown MenuPane, this action wraps to the
  821.                     tear-off control, if present, or else it wraps to
  822.                     the top, leftmost menu item of the MenuPane.  The
  823.                     preceding description applies when the
  824.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn horizontal direction is
  825.                     XXXXmmmmLLLLEEEEFFFFTTTT____TTTTOOOO____RRRRIIIIGGGGHHHHTTTT. If the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn
  826.                     horizontal direction is XXXXmmmmRRRRIIIIGGGGHHHHTTTT____TTTTOOOO____LLLLEEEEFFFFTTTT, then the
  827.                     following applies.
  828.  
  829.                     When the current menu item is in a MenuBar, then
  830.                     this action disarms the current item and arms the
  831.                     MenuBar item to the right.  This action wraps
  832.                     within the MenuBar.
  833.  
  834.                     In MenuPanes, if the current menu item is not at
  835.                     the right edge of a MenuPane, this action disarms
  836.                     the current item and arms the item to its right.
  837.                     If the current menu item is at the right edge of a
  838.                     submenu attached to a MenuBar item, then this
  839.                     action unposts the submenu and traverses to the
  840.                     MenuBar item to the right, wrapping if necessary.
  841.                     If that MenuBar item has a submenu, it posts the
  842.                     submenu and arms the first traversable item in the
  843.                     submenu.  If the current menu item is at the right
  844.                     edge of a submenu not directly attached to a
  845.                     MenuBar item, then this action unposts the current
  846.                     submenu only.
  847.  
  848.                     In Popup or Torn-off MenuPanes, when the current
  849.                     menu item is at the right edge, this action wraps
  850.                     within the MenuPane. If the current menu item is
  851.                     at the right edge of the MenuPane and not in the
  852.  
  853.  
  854.  
  855.      Page 13                                         (printed 10/3/02)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  863.  
  864.  
  865.  
  866.                     top row, this action wraps to the leftmost menu
  867.                     item in the row above. If the current menu item is
  868.                     in the upper, rightmost corner, this action wraps
  869.                     to the tear-off control, if present, or else it
  870.                     wraps to the bottom, leftmost menu item in the
  871.                     MenuPane.
  872.  
  873.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
  874.                     When the current menu item is in a MenuPane, then
  875.                     this action disarms the current menu item and arms
  876.                     the item above it.  This action wraps within the
  877.                     MenuPane. The direction of the wrapping depends on
  878.                     the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.
  879.  
  880.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  881.           The bindings for virtual keys are vendor specific.  For
  882.           information about bindings for virtual buttons and keys, see
  883.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).
  884.  
  885.      RRRREEEELLLLAAAATTTTEEEEDDDD
  886.           OOOObbbbjjjjeeeecccctttt(3), RRRReeeeccccttttOOOObbbbjjjj(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt(3),
  887.           XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttCCCCrrrreeeeaaaatttteeee(3), XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee(3),
  888.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeeeLLLLttttooooRRRR(3), and XXXXmmmmGGGGaaaaddddggggeeeetttt(3).
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.      Page 14                                         (printed 10/3/02)
  922.  
  923.  
  924.  
  925.